Summary

This PR keeps the browser fixes that still add value on top of the latest main:

• unify browser teardown so manual close, inactivity cleanup, and emergency cleanup share the same cleanup path
• make local agent-browser execution more reliable by preferring the Hermes-managed Node binary in PATH
• restore screenshot fallback recovery when agent-browser returns human-readable output instead of JSON
• improve screenshot capture by requesting full-page screenshots and honoring the actual screenshot path returned by the CLI

What Changed

Cleanup and session lifecycle

• changed browser_close() to delegate to cleanup_browser() instead of performing a partial inline shutdown
• changed _emergency_cleanup_all_sessions() to route through cleanup_all_browsers() and then clear:
  • _active_sessions
  • _session_last_activity
  • _recording_sessions
• added regression coverage for cleanup bookkeeping so the explicit close path and emergency cleanup path stay aligned

Local browser command reliability

• shortened local session names to reduce Unix socket path pressure
• updated _run_browser_command() to prefer $HERMES_HOME/node/bin before the standard system path entries
• still preserves the normal system directories in PATH for minimal service environments

Screenshot and non-JSON handling

• added _extract_screenshot_path_from_text() to recover real absolute .png paths from human-readable agent-browser output
• changed non-JSON CLI output handling to fail clearly by default instead of treating arbitrary text as success
• added a screenshot-specific recovery path that still returns success when a real screenshot file was created
• updated browser_vision() to:
  • pass --full to agent-browser screenshot
  • use the actual screenshot path returned by the CLI when it differs from the requested output path

Tests

• added tests/tools/test_browser_cleanup.py coverage for:
  • screenshot path extraction
  • cleanup_browser() state cleanup
  • browser_close() delegation
  • emergency cleanup state clearing

Not Included

• this PR intentionally keeps the latest main behavior that removed browser signal handlers
• it does not reintroduce the old SIGINT/SIGTERM browser cleanup hooks that were removed upstream for voice-mode stability

Verification

Passed:

• source venv/bin/activate && python -m pytest tests/tools/test_browser_cleanup.py tests/tools/test_browser_console.py tests/gateway/test_send_image_file.py -q

Current full-suite state on this branch:

• source venv/bin/activate && python -m pytest tests/ -q
• this is not currently green in this checkout; it fails during collection around tests/run_interrupt_test.py with SystemExit / xdist internal errors
• that failure is outside this PR's diff